home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / EXT / A-E / AutoBlack.cpt / AutoBlack / AutoBlack Doc < prev    next >
Text File  |  1987-12-08  |  8KB  |  173 lines
  1. AutoBlack(tm) -- The screen saver with a light touch -- User Notes Version 1.5
  2.  
  3. When AutoBlack is installed, after five minutes of user inactivity, the Mac 
  4. screen will go black to prevent burning an image of the desktop (or whatever is 
  5. on the screen) into the phosphor of the CRT.  Any user activity (move the mouse, 
  6. press any key, insert a disk) will immediately restore the current contents of 
  7. the screen display with no waiting for system "update events" to redraw it.  The 
  8. five minute timer restarts from the last time of user activity, and may be set
  9. by the user to any desired value.  As a special feature, there are two built-in 
  10. variants on the delay time.  If the mouse is pushed all the way into the top 
  11. right-hand corner of the screen, the delay is reduced to about two seconds 
  12. regardless of the delay setting, so you can hide the screen in a hurry if you 
  13. need to do that.  Alternatively, if the mouse is pushed all the way into the 
  14. bottom right-hand corner of the screen it takes a couple hours, so if you are 
  15. passively watching computer output you don't need to alter the delay time nor
  16. keep moving the mouse every few minutes.
  17.  
  18. While the screen is turned off an analog clock icon is displayed at random 
  19. positions, to show that the Mac is still turned on.  The clock will show the 
  20. correct time of day if the program running at that time has a normal Macintosh 
  21. interface (that is, it is calling the SystemTask trap from time to time).  If
  22. the clock shows random times, changing every time it is drawn, it is because
  23. you have not set the time and date correctly since you last removed the battery.
  24.  
  25. INSTALLATION
  26. AutoBlack can be installed in any of three ways.  Primarily it is designed to 
  27. install itself in RAM on bootup.  To do this requires that it be present in the 
  28. system folder on your bootup disk.  Alternatively, it can be double-clicked as
  29. an application from any folder.  After it is installed, it is not needed on any 
  30. disk drive, and it will continue to be active no matter what the Mac is doing, 
  31. until you power off, Shut-down or press the Reset button.
  32.  
  33. The preferred method to install this program at bootup is to copy it to the 
  34. system folder of your bootup disk and rename it "MacsBug".  The operating system 
  35. always loads in a file named "MacsBug" (if it is there) before it does anything else, 
  36. and it is important that AutoBlack be loaded in first, before any RAMdisk 
  37. or even MacsBug itself.  If you need MacsBug to be loaded also, rename it 
  38. "Disassembler" and it will be loaded in after AutoBlack.  Next time you boot up, 
  39. AutoBlack will install itself in RAM (but the bootup box will say "MacsBug 
  40. installed").
  41.  
  42. AutoBlack is also configured to install as an "INIT" file.  In this mode you can
  43. name it anything you wish; System 3.2 and later versions will look for all INIT
  44. files like AutoBlack in the system folder and start them up as part of its boot
  45. procedure.  If you have other INITs or the real MacsBug in the system folder, 
  46. this may fail.  If you have the 128K ROMs (that is, you are using a double-sided 
  47. internal drive) the INITs are loaded in alphabetical order; you can just rename 
  48. the other INITs so they come later in the alphabet.  If AutoBlack is not able to 
  49. install properly, a dialog will inform you of its failure.  If the AutoBlack
  50. INIT file is named "MacsBug" it is guaranteed to install first, and you will see
  51. both the "MacsBug installed" message and a little notice put up by the INIT.
  52.  
  53. If other INITs, RAMdisks, or immortal desk accessories have not yet overwritten
  54. the memory required by AutoBlack, you can also run it as an application program.
  55. If you double-click on the AutoBlack icon from the Finder, you will normally get
  56. a message "An application cannot be found for this document."  Hold the option
  57. and cloverleaf keys down while double-clicking to avoid this problem.  Or you
  58. can use DeskZap, Fedit, or Resedit to change the file type to "APPL".  This will
  59. result in a different icon (a Mac screen with the familiar hand in front of it);
  60. you can double-click this icon with no impediment.
  61.  
  62. You can run the application any time, even after AutoBlack is installed.  It
  63. allows you to change the delay time from the default five minutes.  Setting the
  64. delay time to zero disables AutoBlack, but you can always run the application
  65. again to start it back up with a new delay time.
  66.  
  67. My preference is to use AutoBlack in the APPL mode, name it "MacsBug", and leave
  68. it in the system folder.  That way it always installs itself at bootup without
  69. requiring manual attention, but I can still easily double-click it to change the
  70. delay setting.
  71.  
  72. HOW IT WORKS
  73. AutoBlack takes over the alternate display area and paints it black (except for 
  74. the clock icon).  Then a small task is installed in the vertical retrace queue 
  75. of the Macintosh (when it also looks at the mouse and keyboard), which counts 
  76. the time since the last user activity.  Once the delay time is exceeded, the 
  77. video hardware is switched to the alternate display.  Any time user activity 
  78. takes place, the display is switched back to the normal display area, and the 
  79. timer is restarted.  The Macintosh software is not told about the switch, so it 
  80. continues to update the normal display area; thus the display is immediately 
  81. current whenever the hardware is switched back.  Programs continue to run 
  82. normally even when the display is switched off, and their output will be there
  83. when you switch back.  Programs that depend on the alternate screen may not work 
  84. correctly, if at all.
  85.  
  86. Unlike other programs that load in at bootup time, it is essential that 
  87. AutoBlack be first to load -- even before the debugger -- to get access to the 
  88. alternate screen.  INIT files other than AutoBlack often take part of the memory
  89. used by the alternate screen; if they get there first, AutoBlack cannot install
  90. itself.  If it fails to load as an INIT, simply rename it "MacsBug" and try 
  91. again.  Some systems, notably the HyperDrive 2000, rejuggle the memory hardware 
  92. at INIT time; there is no way for AutoBlack to install at the proper time in such 
  93. a wierd system.  Some INITs leave a lot of trash in the heap when they are done;
  94. AutoBlack has been known to crash after such dirty predecessors.  Renaming the
  95. files so AutoBlack loads first usually clears up the problem.
  96.  
  97. NOTICE
  98. AutoBlack™ is Copyright © 1987 by Itty Bitty Computers.  Version 1.2 was free,
  99. but I put some extra work into making version 1.5 into an INIT and a double-
  100. clickable program, and also making it work with large screen hardware and 
  101. software.  I'm asking $5 (shareware) if you appreciate AutoBlack and would like 
  102. me to write more useful Mac Software.  AutoBlack may be freely distributed but 
  103. not for profit, if it is unmodified and this document is included.
  104.  
  105. Itty Bitty® is a registered trademark of Itty Bitty Computers.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119. -  -  -  -  -  -  -  -  -  -  -  Cut Here  -  -  -  -  -  -  -  -  -  -  -  -
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                      Staple or tape $5 here, 
  126.                      Then fold with this flap inside
  127.                      Tape all edges shut, add stamp,
  128.                      Then drop into any mailbox.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. -  -  -  -  -  -  -  -  -  -  -  Fold Here  -  -  -  -  -  -  -  -  -  -  -  -
  136. Please Register AutoBlack to:                                         _______
  137.                                                                      |       |
  138. ___________________________                                          | PLACE |
  139. (name)                                                               | STAMP |
  140.                                                                      | HERE  |
  141. ___________________________                                          |_______|
  142. (address)
  143.  
  144. ___________________________ 
  145. (city)        (state)  (zip)
  146.  
  147.  
  148.                                    Itty Bitty Computers
  149.                                    P.O. Box 6539
  150.                                    San Jose, CA  95150-6530
  151.  
  152.  
  153.  
  154.  
  155.  
  156. -  -  -  -  -  -  -  -  -  -  -  Fold Here  -  -  -  -  -  -  -  -  -  -  -  -
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.